package cn.tedu.pdfamily.product.mapper;

import cn.tedu.pdfamily.product.pojo.entity.User;
import cn.tedu.pdfamily.product.pojo.vo.UserListItemVO;
import cn.tedu.pdfamily.product.pojo.vo.UserLoginInfoVO;
import cn.tedu.pdfamily.product.pojo.vo.UserStandardVO;
import org.springframework.stereotype.Repository;

import java.util.List;

/**
 * 处理用户数据的Mapper接口
 *
 * @author java@tedu.cn
 * @version 0.0.1
 */
@Repository
public interface UserMapper {

    /**
     * 插入用户数据
     *
     * @param user 用户数据
     * @return 受影响的行数
     */
    int insert(User user);

    /**
     * 批量插入用户数据
     *
     * @param userList 若干个用户数据的集合
     * @return 受影响的行数
     */
    int insertBatch(List<User> userList);

    /**
     * 根据id删除用户数据
     *
     * @param id 用户id
     * @return 受影响的行数
     */
    int deleteById(Long id);

    /**
     * 批量删除用户
     *
     * @param ids 需要删除的若干个用户的id
     * @return 受影响的行数
     */
    int deleteByIds(Long[] ids);

    /**
     * 根据用户id修改用户的数据
     *
     * @param user 封装了用户id和新的数据的对象
     * @return 受影响的行数
     */
    int update(User user);

    /**
     * 根据用户名统计用户的数量
     *
     * @param username 用户名
     * @return 匹配用户名的用户的数据
     */
    int countByUsername(String username);

    /**
     * 根据手机号码统计用户的数量
     *
     * @param phone 手机号码
     * @return 匹配手机号码的用户的数据
     */
    int countByPhone(String phone);

    /**
     * 根据电子邮箱统计用户的数量
     *
     * @param email 电子邮箱
     * @return 匹配电子邮箱的用户的数据
     */
    int countByEmail(String email);

    /**
     * 根据id查询用户详情
     *
     * @param id 用户id
     * @return 匹配的用户详情，如果没有匹配的数据，则返回null
     */
    UserStandardVO getStandardById(Long id);

    /**
     * 查询用户列表
     *
     * @return 用户列表
     */
    List<UserListItemVO> list();

    /**
     * 根据用户名查询用户的登录信息
     *
     * @param username 用户名
     * @return 匹配的用户的登录信息，如果没有匹配的数据，则返回null
     */
    UserLoginInfoVO getLoginInfoByUsername(String username);
}
